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Chapter 1 Introduction 


1.1 Before You Begin 


Two tools are available for display distribution in an Advant Station 500 Series Operator 
Station. With the standard function Display Transfer the display source code can be copied to or 
from other operator stations. The installer tool has then to be used in each operator station to 
convert the display source code to object code for runtime use. 


The other tool, AdvaBuild Display Distribution Services - also called Display Tool, is an 
software option. The Display Tool has more functionallity than the Display Transfer function 
and is described in this user’s guide. 


The Display Tool is a menu-driven, interactive tool used by the plant engineer to specify how 
displays should be handled both locally and in a distributed environment. Automatic distribution 
and installation may be ordered for a complete network of operator stations. The information 
provided in this manual is intended for the plant engineer. Some knowledge about Unix 
networking is required. 


1.2 Equipment Requirements 


3BSE 007 959R1 RevA 


This software package runs in an Advant Station 500 Series Operator Station (AS 5000S) 
version 1.8/2 or later. 
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1.3 How to Use This Book 


This book is organized into chapters and sections as shown in Figure 1-1. 


Chapter 
Introduction Installation Configuration eenion Maintenance Appendices Index 
Before You Site Planning Considerations Operating Maintenance 
Begin Overview 
Installation Capacity & Error 
Equipment Procedures Performance Operating Messages 
Requirements Applicati Instructions iadi 
Shut-down plicauion Fault Finding 

How to Use Procedures Start-up Runtime & User Repair 
This Book Tutorial Operation \ 
Conventions Soe. ee Menus nection 

ee eMtee Application 
Related Product Procedures 
Documentation Verification ,; 

Configuration/ 

Release Application 
History Building Menus 
Terminology 
Product 
Overview 


User Interface 
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Figure 1-1. Organization of manual 


Introduction 


This chapter provides a general description of the Display Tool, its usage and its interaction with 


the operator station 


Installation 


The Display Tool is delivered as an option to the Advant Station 500 Series Operator Station. 


However, the display distribution has to be activated, and this is described in this chapter. 


Configuration and Application Building 


Configuration and Application Building describes the general concept used for display 
distribution. It also describes common functionality and how to configure a distribution. 


Runtime Operation 


This chapter describes how to use display installation and display distribution in runtime. 
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Maintenance 


This chapter describes common errors and how to correct them. It also describes how to handle 
and maintain libraries and displays. 


The names of keyboard keys, push buttons, menus and menu items are boldfaced in this manual. 
For example: 


¢ Press the key <System Config> 
° Click OK 
° Select Distribute from the Action menu 


System Config is a keyboard key, OK is a push button, Distribute is a menu item and Action is 
a menu. 


In several of the information windows there is a date and time field. An empty date and time 
field is indicated with ---. One example of empty date time is if you look at the distribution 
status before a display is distributed. 


1.5 Related Documentation 


Table 1-1 lists all documentation related to the Display Tool. 


Table 1-1. Related documentation 


Category Title Description 
Software AdvaCommand Basic Functions User’s Guide | This book gives a detailed description of all 
basic functions in AdvaCommand, including 
User Interface, Event and Alarm, and System 
Status. 
AdvaCommand User Interface Reference This book gives a detailed description of all 
Manual basic display elements and dialogs in 
AdvaCommand. 
Options AdvaBuild Display Builder User’s Guide This book provides instructions for accessing, 
and using all Display Builder functions. 
AdvaCommand Process Sectioning User’s This book provides instructions for accessing, 
Guide and using all Process Sectioning functions. 
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1.6 Release History 


This is the first release of the AdvaBuild Display Distribution Services, also called Display 


Tool, software. 


1.7 Terminology 


Before beginning to work with the Display Tool, it is important that you understand the basic 
terminology used throughout this manual. 


The following is a list of terms associated with Advant Station 500 Series Operator Station that 


you should be familiar with. 


Term 


Category 


Display 


Display Client 


Display Element 


Display Server 


Distribution 


Installation 


Library 
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Description 


There are three categories of displays, Standard displays, 
Adaptions displays, and Customer displays. Standard displays are 
delivered with all operator stations, displays on Adaptions may 
have been added for your special Business Area, and finally 
Customer is where you put your own displays. 


A display is everything that may be brought up on the Base 
Display Area or as an Overlap Display on the Advant Station 500 
Series Operator Station. 


A display client is a node receiving displays from the display 
server. A display client does not normally have the source code 
for it’s displays. 


A display element mirrors the object status of a process object, 
like an Analogue Input (AI), Analog Output (AO) etc. For a 
display to be installable, all the display elements referenced from 
a display must be available. 


A display server is the node holding the source code for all 
displays distributed in the network of operator stations. 


Distribution means to copy a set of displays from a central display 
server, to all connected remote Advant Station 500 Series 
Operator Station specified to receive the displays. 


To install a display is to make it available as a Base Display or as 
an Overlap Display on the Operator Station. 


For each category there are one or several display libraries. 
Libraries is used as a grouping mechanism. 
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Term Description 
Node A node is the same as an operator station. 
View A view is a collection of nodes that have a set of displays in 


common. Views are introduced to simplify the specification of 
which displays that should be distributed to which operator 
stations. Example a plant may have three views: 


- Overview 

Containing all operator stations in the network. 
- Area | 

Containing all operator stations controlling area 1 of the factory. 
- Area 2 


Containing all operator stations controlling area 2 of the factory. 


1.8 Product Overview 


1.9 User Interface 
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The Display Tool is available for purchase as an option for an Advant Station 500 Series 
Operator Station. 


The Display Tool is using an OSF/Motif user interface. How to operate the user interface is 
described in the ordinary Advant Station 500 Series Operator Station documentation set. 


Most of the menu items and menu options are directly available from the keyboard without 
using the mouse or track-ball. The menus available from the keyboard have one of it’s 
characters underlined. 


To select a menu item, press the <Left Extend Char> key on the keyboard, followed by the 
underlined character. The selected menu item is then brought up and you can see the menu 
options to select from. To select a menu option press the underlined character. 
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Chapter 2 Installation 


2.1 Site Planning 


AdvaBuild Display Distribution Service is an option in the Advant Station 500 Series Operator 
Station. The option need to be loaded in both display server and client nodes. For a description 
of how to load the option see Release Notes for the operator station. 


2.2 Installation Procedures 


The network must be configured correctly to make display distribution with the AdvaBuild 
Display Distribution Service work. See HP/UX documentation about network configuration, for 
example the manual Installing and Administrating LAN/9000 Software. 


In the /etc/hosts file on all nodes it’s convenient if the server node has an additional name (e.g. 
server) to ensure that the local installers find the distributer server node. The host name server 
is set as default in the Distribution Configuration when the option is loaded. If the additional 
name isn’t defined in the hosts file then the server name in the Distribution Configuration must 
be changed to the hostname of the server, e.g. os4. The name of the server is changeable via the 
Distribution Configuration, Section 3.4.2.1, Configure Client Node. 


Example of additional name in /etc/hosts 
127.230.43.6 os3 

127.230.43.7  os4 server 
127.230.43.8  os5 


2.3 Shut-down Procedures 


There are three ways to disable the display distribution on an operator station. 
1. An operator station can be set in stand-alone state 


2. An operator station can be set in suspended state from the display server using the Display 
Tool. 


3. The central display server can be set in suspended state using the Display Tool. 


For information how to set an operator station in stand-alone state, see Section 2.4, Start-up 
Procedures 


For information on how to suspend the display distribution on a node or suspend the distribution 
server, see Section 3.5.6, Node Activation. 
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2.4 Start-up Procedures 


By default an Advant Station 500 Series Operator Station is set as a stand-alone station at start- 
up. To make the station act as a display client or as a display server you have to configure the 
distribution service. To do this you press <System Config> on the operator’s keyboard and 
select the dynamic key D7 marked Maintenance.... Then press the dynamic key D8 marked 
Distribution config. This gives you a popup dialog where you may select one of three 
alternatives: 


° Server 


The operator station made to be the display server. The hostname of the server must also 
be defined. 


° Client 


The operator station is made a display client and gets its displays from the display server. 
The hostname of the server must also be defined. 


¢ Stand-alone 
The operator station will work completely stand-alone from the network, i.e it will not 


receive any distributed displays. 


NOTE 


It’s possible to have more than one Advant Station 500 Series Operator Station 
configured as a display server but the displays will NOT be synchronized 
between the display servers. 
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2.5 Product Verification 


Verify that the network is correctly setup by doing /etc/ping towards all nodes. For more 
information about the ping command, see the Unix handbooks. 


You check that the Display Tool is installed in your Operator Station by pressing the dynamic 
key <D9> (Installed Options) in the Basic Display. 


= INSTALLED OPTIONS 

A 
Limit of allowed tags unlimited 
German displays no tl 
Swedish displays no 
Chinese displays no 
AdvaCommand Process Sectioning yes 
AdvaCommand Status List yes 
AdvaCommand X Workplace Server yes 
AdvaCommand Drives Integration no 
AdvaBuild Display Builder yes 
AdvaBuild Display Distribution Services yes 7 
AdvaBuild Central Backup yes 
AdvaBuild On-line Builder yes 
Safeguard no 
HP Netstation no 
Advalnform History no 

Ny 

I I 


Figure 2-1. Installed Options dialog box 


Start the Display Tool on the server by pressing the key <System Config> on the operator’s 
keyboard and then press <D2> (Display Tool), select the item Node activation under the File 
menu and verify that all expected display clients are connected. 
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Chapter 3 Configuration/Application Building 


3.1 Considerations 


The Display Tool is used to manage displays in the Advant Station 500 Series Operator Station 
environment. The management of displays includes installation of displays in local nodes as 
well as distribution (transfer of displays to other nodes and installation there). The Display Tool 
also allows removal of displays and some other services such as information about the current 
state of a display. 


In the Advant Station 500 Series Operator Station products displays exist in two forms, a source 
form and an object form. The Display Builder uses the source form and the run-time uses the 
object form. The Display Tool converts the source form into the object form. This conversion 
process is called installation. 


The Display Tool makes it possible to have the source for displays on one operator station 
(called the display server) and allow distribution of different sets of displays to any operator sta- 
tion (display client) within the network. Distribution takes place using TCP/IP. 


Display Server 


———— sy 


Plant Network TCP/IP 


Display Client Display Client Display Client 


LJ UW 


Figure 3-1. Hardware configuration 


One operator station on the network is chosen to be the display server. The display server 
operator station is a standard operator station, but with the distribution services running in 
server mode. It is advantageous if this operator station is placed on the plant network so that all 
displays can be tested locally on this station before they are distributed. The display server 
should typically have more secondary storage capacity (more disk space) as it will hold more 
displays than a normal station, as well as the source code for all distributed displays. 


NOTE 
The Display Tool requires a TCP/IP network to be able to distribute any displays. 
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3.1.1 Node States 
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The display server operator station in Figure 3-1 holds all the source code, one locally installed 
object form copy and one object form copy that is distributed. The remaining client operator 
stations only have the object form for their displays. 


The distribution of displays goes from the display server to each node specified to receive 
displays from the display server (see Section 4.2.2, Distribution of a Display). To ensure that the 
distribution service does not malfunction due to disk failures etc. as well as protecting clients 
from misuse, each display client in the network is assigned a state from the display server. 


Possible states are: 


Blocked 


This is the initial state. Both display server and display clients comes up in this state at the 
first start-up. Before any distribution takes place a node must be manually set to running 
state. 


All nodes are also set to this state if the display server detects an inconsistency when 
checking its data files. 


CAUTION 


If a node gets blocked after you have set the node in running state, make sure to 
check that all views and displays still are configured correctly before setting the 
node into running again. If you ignore this check a disk failure or accidental 
misuse from the Unix command level on the server node may erase all displays on 
all nodes you put in running state. 


Suspended 


The user of the Display Tool may set nodes in a suspended state during which the 
distribution is disabled for the selected nodes. This state should be used to make sure that 
display updates only happens during selected time periods (i.e. the user may select to have 
all stations updated during a certain time period each day). 


Protected 


The protected state runs all distribution operations, except display remove, as normal. 
This mode should be used to ensure that displays do not get accidentally removed. 


Running 


The running state allows all update and removal operations. 
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3.1.2 Display Views 


To list all displays for all nodes can be a quite cumbersome operation. Therefore a display view 
concept is introduced. A view is a list of nodes that have a set of displays in common. Each 
distributed display is assigned to one or more views. 


View All 


View Dryer 


Display View 


DetailDryer Dryer 
Overview All 


OverviewDryer Dryer, All 


Figure 3-2. Example with two views, Dryer and All 


The general recommendation is to structure the views according to the following criteria 
° One view is used for the displays distributed to all nodes. 
° Create one view per process section. Compare with the process sectioning. 


See AdvaCommand Process Sectioning User’s Guide for more information about process 
sectioning. 


If the server is supposed to be a part of the distribution it must be a part of all views, which is 
also recommended. 


3.1.3 Redistribution of Displays 


The display distribution function does also allow redistribution of displays changed and 
installed on any Advant Station 500 Series Operator Station. This functionality is only used for 
trend displays, but if an ordinary process display that is part of a view is installed in a client then 
it also will be redistributed. 


For trend displays this functionality is used to let the operator save display changes directly 
from the trend display in all operator stations, after a while they are present in all other clients. 


Redistribution takes place automatically when a display is installed on a client. 
Source code for a trend display changed on a client is automatically restored to the server’s 


display library. 


NOTE 


If source code for a display other than trend is changed locally and installed on a 
client than the server’s source code is not up to date any more. 
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3.1.4 Distribution Principles 
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The AdvaBuild Display Builder is used to produce most types of displays in the 
Advant Station 500 Series Operator station. These displays are then converted into the object 
form by the Display Tool and can thereafter be distributed and used in an operator station. 


The following steps should be performed to create a new display: 


1. 
2. 
3: 
4. 


Create the display using the AdvaBuild Display Builder 


Install the display locally with the Display Tool 


Test the display locally and verify that the display works correctly. 


Add the display to a view and distribute it using the Display Tool. 


A distributed display is always copied to a distribution directory before it is copied to any 
remote nodes. 


The figure below shows the sequence a display goes through when it is distributed: 


Source directory 


Source 
Format 


_W 


Install 


Object directory 


Object 
Format 


Display Server 


Distribution directory 


Object directory 


Object 
Format 


Distribution 
| 


Object 
Format 


SS 


Distribute 


Display Client 


Figure 3-3. Display format and storage 


The method with two separated directories, one for the local displays and one for the displays 
distributed to other nodes, makes it possible to change and test a display locally on the display 
server, without disturbing the other nodes using a display. 


NOTE 


The disc usage for a display will almost double on the display server when a 
display is distributed. This means that the display server must be equipped with 
more disc storage than remaining operator stations. 
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A display may be present in several source libraries using the same display name, but only one 
of the displays can be installed and distributed at the same time. A special icon indicates if a 
display with the same name is installed from another library. (See Figure 4-1.) 


The Display Tool supports removal of displays in three ways. A display can be removed from 
other operator stations, from the local station or completely (removing the source format). 


A display may not be removed on the display server, before it is removed from all remote nodes. 


3.2 Capacity and Performance 


The display distribution is done on the TCP/IP network with very little overhead. Distribution of 
a display takes approximately 2-3 seconds. In addition to this there is a 4 second delay between 
distribution of each display, this is so the operator still shall be able to control the process. 


3.3 Application Start-up 
To start Display Tool in the display server operator station: 


1. Press the key <System Config> on the operator function keyboard. 


A dialog is displayed at the bottom of the screen: 
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D1 


AdvaCommand... 


D2 


AdvaBuild... 


D4 


DS 


Settings... 


Station... 


Maintenance... 


D10 


Figure 3-4. Dynamic function keys - System configuration dialog 


Click on the D2 AdvaBuild dynamic function key or press the D2 key on the operator 


keyboard. 


A new dialog is displayed at the bottom of the screen: 


D1 


Display Builder 


D2 


Display Tool 


D3 


Display Transfer 


D4 


DS 


D6 


On-line Builder 


Text Editor 


D8 


D9 


D10 


Click on the D2 Display Tool dynamic function key or the D2 key on the operator 


keyboard. 


The authorization key must be in the position for Max dialog to use the Display 


Tool. 


Figure 3-5. Dynamic function keys - AdvaBuild dialog 


NOTE 
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3.3.1 Leaving the Display Tool 


To leave the Display Tool select Exit in the File menu in the upper left corner of the Main 
window. 


3.4 Tutorial 


In this tutorial we describe how to create and configure a distribution configuration with a server 
and a client. The tutorial describes some typical steps that you have to perform to add a server, a 
client and to remove a client. 


Since this section is a tutorial, not every feature of the Display Tool is discussed. See the other 
sections in this manual for examination of other features and functions not described in this 
section. 


3.4.1 Adding a Server 


3.4.1.1 Server Preparations 


Prepare the configuration of the server. This means collecting all customer display elements 
from the client node/nodes and saving them on the server node. Below is a list of configuration 
items that are common for all OS stations. 


- Customer display elements 

- Customer bitmaps 

- Customer nls files 

- Host file (/etc/hosts) definitions of all hosts in the TCP/IP network 


Collect source code of all process displays from all clients on the server. That can require 
arrangement of libraries and changing names of displays. 


3.4.1.2 Configure Server Node 


If the node not already is configured as a server it has to be configured as one. Start Distribution 
Config in the server operator station: 


1. Press the key <System Config> on the operator function keyboard. 


A dialog is displayed at the bottom of the screen: 


D1 D2 D3 D4 DS 


AdvaCommand... AdvaBuild... 


. D7 2 D8 : 
Settings... Station... Maintenance... 


Figure 3-6. Dynamic function keys - System configuration dialog 
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2. Click on the D8 Maintenance dynamic function key or press the D8 key on the operator 
keyboard. 


A new dialog is displayed at the bottom of the screen: 


1 RTA Board Backup D2 Station Backup 3 Central Backup 4 RTA Board Config. 8 View Diagnostic Log 


De. D7 D8 = (DO ee 5. ¢ D10 
Object References Node Broker Log Database Config Distribution Config. 


Figure 3-7. Dynamic function keys - Maintenance dialog 


3. Click on the D9 Distribution Config dynamic function key or the D9 key on the operator 
keyboard. The Distribution Configuration window is displayed. 


— | Distribution Config. 
Choices: 


Client 
server 
standalone 


Selection: 


server 


Server: 


server 


OK 


Figure 3-8. Server Distribution Configuration window 


Configure the node as server and make sure that the server’s host name, for example 
server, is defined in the /etc/hosts file. 


NOTE 


The authorization key must be in the position for Max dialog to use the 
Distribution Configuration. 
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3.4.1.3 Start the Display Tool 


Start the Display Tool in the server node, see Section 3.3, Application Start-up. The Display 
Tool window is displayed, see below, and gives a description of the main window and the fields 
used for different purposes. 


= Display Tool = 
File Select Action Information Installing Distributing Uninstalling Errors V4 Help 
2 Mew focus: novnller = Inst Dist Display Views Description 
— 
Category Customer = 
Libraries 
ALARM_LINE 0 = 4 
ALARM_LIST 2 
Process_Section_1 32 
Process_Section_2 1 
Process_Section_3 26 
Process_Section_4 11 
Process_Section_5 35 
3 se EVENT_LIST 0 
examples 33 
SYSTEM_LIST 12 
Messages 
Initializing library Process_Section_4... ~= 6 
5 —4 
Initializing library Process_Section_5... ae 
Retrieving distribution messages ... S| 


Figure 3-9. Display Tool main window 


The numbers | to 6 indicate different areas in the Display Tool: 
1. Menu bar 

Used to select all functions available in the Display Tool 
2. Category select and View focus buttons 


Used to select current category and view focus. For a description of Category 
see Section 1.7, Terminology. 


3. Library select area 


Used to select the library to get the display from. This area also shows number of displays 
within a library. 
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4. Display select area 

Used to select the display to install, distribute and remove. 
5. Message area 

Messages about the installation and distribution are shown in this area. 
6. Status summery 


Used to indicate the distribution status. If the symbol is green, the distribution is ready and 
without error. If the symbol is yellow, a distribution is going on. If the symbol is red, there 
is some distribution error for one or more displays. 


3.4.1.4 Activate Server Node 


The Node Activation window is used to control the state of the nodes. The nodes must be in 
Running state to be able to send and receive displays from the server. See Section 3.5.6, Node 
Activation for more information. 


o Node Activation 


File Action 


Server state: Running 


Clients: Connection: State: 


os101 Connected Blocked 
os201 Connected Running 
os202 Connected Suspended 
0s301 Connected Running 


Figure 3-10. Node Activation window 
3.4.1.5 Install Displays on Server Node 


Start the Display Tool in the server node and install all displays. See Section 4.2.1 Installation of 
displays for install description of displays. 
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If the displays not have been divided into libraries during the preparation of the server it must be 
done now. It may require arrangement of libraries and changing names of displays. 


i Display Tool 
Eile Select Action Information Installing Distributing Uninstalling Errors Help 
Install 
View focus Bistibtte 
Uninstall Inst Dist Display Views Description 


Remove Source 
Move Displays 


Cat MS BB TREND1 ~——Process_Section_2 Scrubber speed. 
ategory Add Library 

Remove Library | | 1 TREND2 Process_Section_2 Process engines temp. 
Libraries Rename Library 


Reload Display Info 
Process_Section_1 
Process_Section_2 
Process_Section_3 
Process_Section_4 
Process_Section_5 


| | | | TREND3 Process_Section_2 Process flow and alarms. 


Figure 3-11. Install a display in the Display Tool 


3.4.1.6 Create Views 


To be able to distribute any displays, views configured with client nodes have to be defined. This 
is done in the View Configuration window. 


A view specifies the nodes a display shall be distributed to. One display can be distributed to 


many views and a view can contain many client nodes. See Section 3.5.1, Define and Configure 
a View for more information. 


5 View Configuration 
File Action Help 
Views Nodes in View Nodes not in View 
A 
V 
Add View Delete View Rename View 


Figure 3-12. View Configuration window 
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3.4.1.7 Activate Client Nodes 


The Node Activation window is used to control the state of the nodes. The nodes must be in 
Running state to be able to send and receive displays from the server. See Section 3.5.6, Node 
Activation for more information. 


2 Node Activation 


File Action 


Server state: Running 


Clients: Connection: State: 


os101 Connected Blocked 
os201 Connected Running 
os202 Connected Suspended 
0s301 Connected Running 


Figure 3-13. Node Activation window 


3.4.1.8 Start Distribution 


When a display is ready for distribution it shall be selected in the Display Tool select area, 
added to a view and distributed. See section 4.2.2 Distribution of a Display for more informa- 


tion. 
oc Display Tool 
File Select Actio Information Installing Distributing Uninstalling Errors Help 
Install 
View focus Bieuibute 
Uninstall Inst Dist Display Views Description 
Remove Source 
Move Displays TREND1 Process_Section_2 Scrubber speed. 
Category Add Library Ee 
Remove Library | i TREND2 Process Section _2 Process engines temp. 
Libraries Rename Library 
Reload Display Info | | BM TREND3 Process _Section_2 Process flow and alarms. 


Process_Section_1 


Process_Section_2 
Process_Section_3 
Process_Section_4 
Process_Section_5 


Figure 3-14. Distribute with Display Tool 
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3.4.2 Adding a Client 


3.4.2.1 Configure Client Node 


The client node has to be configured as a client. See section 3.4.2.1 Configure Server Node for 


3-12 


more information. 


— | Distribution Config. 


Choices: 


client 
server 
standalone 


Selection: 


Client 


Server: 


server 


OK 


Figure 3-15. Client Distribution Configuration window 


Configure the node as client and make sure that the server’s host name, for example server, is 


defined in the /etc/hosts file 
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3.4.2.2 Uninstall Displays on Client Node 


Uninstall all displays in the client and then remove the source code after copying the source 
code to the server. 


To remove the source code is irreversible. Once removed and it is gone for ever, unless you 
bring it in from a backup tape. 


See Section 4.2.1, Installation of a Display for a description of uninstall and remove of displays. 


= Display Tool 
File Select Information Installing Uninstalling Errors Help 
Install 
Category ied . _ 
Remove Source nst isplay escription 
cen ep (i) = TREND1 Scrubber speed. 
Remove Library ; 
ae Rename Library || TREND2 Process engines temp. 
Libraries Reload Display Info 
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Process_Section_1 


Process_Section_2 
Process_Section_3 
Process_Section_4 
Process_Section_5 


| TREND3 Process flow and alarms. 


Figure 3-16. Uninstall a display in the Display Tool 


3-13 


AdvaBuild® Display Distribution Services User’s Guide 
Chapter 3 Configuration/Application Building 


3.4.3 Removing a Client 


3.4.3.1 Stand-alone Preparations 


Prepare the configuration of the stand-alone node. This means collecting all customer and 
adaptions displays from the server that shall be available in the stand-alone node and saving 
them on the stand-alone node. 


3.4.3.2 Block Client Node in Server 


The Node Activation window is used to control the state of the client nodes. The nodes must be 
in Running state to be able to receive displays from the server. 


In this case we want to block the client node that we are about to remove as a client. See Section 
3.5.6, Node Activation for more information. 


3.4.3.3 Configure the Stand-alone Node 


The node has to be configured as stand-alone. See section 3.4.2.1 Configure Server Node for 
more information. 


=| Distribution Config. 


Choices: 


client 
server 
standalone 


Selection: 


standalone 


Server: 


server 


OK 


Figure 3-17. Stand-alone Distribution Configuration window 
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3.4.3.4 Install Displays in Stand-alone Node 


Start the Display Tool in the stand-alone node and install all displays. See section 4.2.1 
Installation of displays for a description of installation of displays. 


co Display Tool 
File Select |2Xsifyy) Information Installing Uninstalling —_ Errors Help 
Install 
Uninstall 
Catego' i 
gory Remove Source Inst ‘Display _ Description 
Move Displays 
Add Library C] TREND1 Scrubber speed. 
Remove Library 
Rename Library i TREND2 __- Process engines temp. 
Libraries Reload Display Info 


| | TREND3_ ‘Process flow and alarms. 


Process_Section_1 


Process_Section_2 
Process_Section_3 
Process_Section_4 
Process_Section_5 


Figure 3-18. Install a display in the Display Tool 


3.4.3.5 Remove Displays on Server Node 


It is not necessary to remove the displays from the “removed client” in the server. If you plan to 
add the node later again then you of course shall let the displays stay for later use. 


If you want to remove the displays start the Display Tool in the server node and uninstall remote 
all displays that only are used in the removed node. See Section 4.2.2, Distribution of a Display 
for more information. 


The next step is to uninstall the displays in the server node with the Display Tool. 
See Section 4.2.1, Installation of a Display for more information. 


When the displays are uninstalled the source code shall be removed with the Display Tool. See 
Section 4.2.1, Installation of a Display for more information. 


3.4.3.6 Views on Server Node 
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It is necessary to remove the “removed client” from the views it has been a part of. If you don’t 
do this you will get distribution icons that indicate ongoing distribution (yellow filled with an 
hour-glass) 


See Section 3.5.1, Define and Configure a View for more information about View 
Configuration. 


3-15 


AdvaBuild® Display Distribution Services User’s Guide 
Chapter 3 Configuration/Application Building 


3.5 Application Procedures 


3.5.1 Define and Configure a View 


A view specifies how to distribute displays in a network of operator stations. A view is a set of 
nodes that have a set of displays in common. 


Each display is specified to be sent to one or more views. 


The figure below is used when referring to the different menus in the Display Tool. 


= Display Tool 
Select Action —_ Information Installing Distributing Uninstalling — Errors Help 
Node Activation... filter 
. jo 
Default Views... Inst Dist Display Views Description 
Exit 
Category Customer = 
Libraries 
ALARM_LINE 0 
ALARM_LIST 2 
Process_Section_1 32 
Process_Section_2 1 
Process_Section_3 26 


Figure 3-19. Configuration of View in Display Tool 


The following steps are recommended to configure a view: 
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1. Select View Configuration option in the File menu of the Display Tool, see Figure 3-19. 


o View Configuration 
File Action Help 
Views Nodes in View Nodes not in View 
A 


<q 
> 


Add View Delete View Rename View 


Figure 3-20. View Configuration window 


2. Select Add Node option in the Action menu of the new view configuration window and 
add all Advant Station 500 Series Operator Stations you want to be able to distribute any 
display to. See Figure 3-20. 


NOTE 


The name you input is checked against the name used for the Unix TCP/IP node 
name. If you get problems in the display distribution, check the node names man- 
ually by looking in the file /etc/hosts to see that the name is a valid reference to an 
Advant Station 500 Series Operator Station. 


3. Create the views you want to use by pressing Add View button in the view configuration 
window. 


4. For each view, select the view and move the nodes needing the view from the list of nodes 
not in view to the list of nodes in view by selecting the node and press the upper arrow 
between the two node lists. 
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The File and Action menu contains the following items: 


Node Activation Starts the Node Activation service. 

Close Exits the service. 

Add View Adds a view to the view list. 

Delete View Deletes a view. If displays are distributed to this view an 


information box is displayed which asks the operator to first 
uninstall remote the displays from the selected view. 


Rename View Renames a view. 
Add Node Adds a node to the “Nodes not in view” list. 
Remove Node Removes a node. 


3.5.2 Selecting Displays 


The Display Tool is using an OSF/Motif user interface. How to operate the user interface is 
described in the ordinary Advant Station 500 Series Operator Station documentation set. 


There are several methods to select displays in the main window, see Figure 3-9. The easiest 
way is to just click on the display you want to work with. If you click on another 

display the first one will be deselected. A display selection may be extended if the <Shift> key 
is pressed at the same time as you click on the display. 


By pressing the <Shift> key and drag of a number of displays they will all get selected. 
By pressing the <Control> key and click on a display it toggles the selection. 


To select a display, for installation or distribution, by clicking may be cumbersome when there 
is a large number of displays. The Select menu may save a lot of clicking. 


It contains the following alternatives, (all selection is done on displays in the current library): 


Select All Select all displays in current library 

Select New Select all displays that are not yet installed. 

Select Installed Select all displays that are installed. 

Select Distributed Select all displays that are distributed. 

Select Modified Select all displays with a source code that are newer than the 


installed version. Indicated with a green icon with a circle in the 
Inst column of the Display Tool main window. 
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Select Updated Select all displays that are distributed, but the installed version is 
newer than the distributed version. Indicated with a green icon 
with a circle in the Dist column of the Display Tool main window. 


Deselect All Remove all selections. 


Shortcuts for the Select menu are available. See Section 1.9, User Interface for a description of 
how they can be used. 


NOTE 


Only libraries in the Category “customer” are supported. Not displays in the 
Categories “standard” and “adaption”. 


3.5.3 View Focus 


Where there is a large number of libraries it may be cumbersome to scroll between them to find 
display information etc. By using the View focus to filter out all libraries without displays 
defined for the selected view the list becomes more practical. 


With a view focus active the displays will also be sorted, so displays within the view is shown 
first, then the remaining displays. 


o Display Tool 

Eile Select Information Installing Distributing Uninstalling Errors Help 
View fi Process_Section_3 
ed a ‘idea Inst Dist Display Views Description 

Eslaaeny Sussner _ [| i TREND3 Process_Section_3 Scrubber speed. 


Libraries 


| | | | TREND4 Process_Section_3 Process engines temp. 


| | BM OTREND1 Process _Section_1 Process flow and alarms. 
Process_Section_1 


Process_Section_2 HB BM OTRENp2 Process_Section_4 Process flow and alarms. 


Process_Section_3 


Process_Section_4 


Figure 3-21. View Focus active in Display Tool 
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3.5.4 Overview Information 
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The Overview Information window gives overview information about the contents in display 
libraries and in distribution views. Choose Overview Information... item from the Informa- 
tion menu. 


oo 


Overview 


File 


@ Node/Library <> Node/View <> View/Library 


os4 


os101 
os201 


Sum: 


Process Section_1 Process Section_2 Process Section 3 Sum: 
9 1 1 11 
4 1 1 6 
10 | 1 12 
23 3 3 


Then select one of the three overview options: 


Figure 3-22. Overview Information window 


Node/Library 


Gives the number of displays from all libraries for all nodes. 


Node/View 


Gives the number of displays from all views for all nodes. 


View/Library 


Gives the number of displays in all views for all libraries. 
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3.5.5 Display Information 


The Display Information window gives a complete information about one display. Choose 
Display Information... item from the Information menu. To get information a display must be 
selected in the list to the left. The same information can also be get by double clicking on the 
display in the Display Tool main window. 


o Display Information 
Eile 
, Displays Display T0002 « 1 
mepey + T0001 Trends A Description Production volume of paper « 2 
ist T0002 Trends View(s) Dryer ~« 3 
T0003 Trends 
T0004 Trends Source Library Trends x 4 
T0005 Trends Installed Library Trends ~ 5 
T0006 Trends Distributed Library Trends ~ 6 
T0007 Trends 
T0008 Trends Start Transfer Time 10:36:56 1998-06-30 
T0009 Trends 
T0010 Trends Node Transferred OS installed ~ 7 


T0011 Trends 


T0012 Trends Cott nls Ok 


Figure 3-23. Display Information window 


The Display Information window contains the following information: 
1. Display name 
The name of the display. 
2. Display description 
A short description text for the display. 
3. Views 


A list of views containing the selected display. 
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4. Source library 
Name of the library where the display was saved in the display builder. 
5. Installed library 


Name of the library where the display was installed. The installed library may be different 
than the source library if the same display name exists in more than one source library. 


There is also an indication if the display is installed in a menu or not. 
6. Distributed library 


Name of the library from where the display was distributed. The distributed library may be 
different from the installed library if the same display name exists in more than one source 
library. 


There is also an indication if the display is installed in a menu or not. 
7. Transfer info 


The transfer status for all nodes expected to get the display. The transfer status is empty if 
the node has not got the display. 


3.5.6 Node Activation 


The Node Activation window shows the state of the server node and all other nodes known by 
the distribution tool. 


2 Node Activation 


File Action 


Server state: Running 


Clients: Connection: State: 


o0si01 Connected Blocked 
o0s201 Connected Running 
os202 Connected Suspended 
0s301 Connected Running 


Figure 3-24. Node Activation window 


Each line in the window has three columns. The first column shows the node name. The second 
column shows if the node is connected or not, and the third column shows the current state of 
the node. A node may be physically connected and the communication up and running, but still 
be indicated as unconnected if the node is set up as stand-alone. 
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If a node is unconnected, then the state indicates the state the node will get when it gets con- 
nected. 


A node may be in four different states: 
° Running 
The node will receive all changed displays when it gets connected. 
° Suspended 
The node is temporary suspended from getting any changed displays. 
¢ Protected 
The node will receive changed files, but no files will be removed from this node. 
¢ Blocked 
The initial state for all display clients is to be blocked. If you have set the node into 


running and it is turned into blocked, then there is a severe error in the display distribution. 


CAUTION 


If a node gets blocked after you have set the node in running state, make sure to 
check that all views and displays still are configured correctly before setting the 
node into running again. If you ignore this check a disk failure or accidental 
misuse from the Unix command level on the server node may erase all displays on 
all nodes you put in running state. 


To change the state of a client node or the display server node, select Action menu in the Node 
Activation window. Before the state of a node can be changed it has to be selected by clicking 
on it. The Action menu contains the following items: 


Resume Server Set the server in state running. This will start all distribution and 
redistribution of displays. 


Suspend Server Set the server in state suspended. This will stop all distribution 
and redistribution of displays. 


Set Suspended Set the selected node in state suspended. This means that they will 
not any longer get any updated displays. 


Set Protected Set the selected node in state protected. This means that they will 
get all updated displays, but displays removed from a view will 
not be removed from the node until the nodes are set in state 
running. 


Set Running Set the selected node in state running. All changes in the display 
server will be propagated to the node immediately. 
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3.5.7 Node Information 


The Node Information window contains information about all displays distributed to the 
selected node. Choose Node Information... from the Information menu. 


a Node Information for node: ws134 
Eile 
Nodes Display: Library: View: Start Time: Transferred: 
DetailDryer Process Section_2 Process Section_2 Mon Jun 22 12:27:20 1998 OK 
ee Overview Process Section_1 Process Section_1 Mon Jun 22 12:46:48 1998 OK 
os 


OverviewDryer Process Section_1 Process Section_1 Tue Jun 23 08:23:21 1998 OK 
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Figure 3-25. Node Information window 
Select a node in the list of nodes. For each display on the node the following information is 
shown: 
° Display 
Display name of a distributed display 
° Library 


The distribution library for the display. See Display Info for a description of the difference 


between source library, install library and distribution library. 
° View 

The view the display resides in. If the display is in more than one view a list is shown. 
° Start Time 

The time when a distribution of the display was started 
° Transferred 


Transfer information 
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The View Information window shows detailed information about the view selected in the view 


list to the left. Choose View Information... from the Information menu. 


a View Information for view: Dryer 
Eile 
Views Display: Library: Start Time: ws134 wsk1 
Overview T0003 Trender Mon Jun 22 12:27:20 1998 OK aoe 
T0004 Trender Mon Jun 22 12:46:48 1998 OK - 
Prcess_Section_2 T0005 Trender Tue Jun 23 08:23:21 1998 OK --- 
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Select a view in the list of views. The following information is shown: 


Figure 3-26. View Information window 


Display name 


Name of the display distributed for the selected view 


Library 


The distribution library for the display. See Display Info window for a description of the 
differences between source library, install library and distribution library. 


Start Time 


Start time for the distribution 


Node transferred list 


A list of nodes expecting to have the display and a flag indicating if they received the 
display. If the transferred flag is ‘“‘---”, then the node has not got this display yet. 
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3.5.9 Distribution Information 


The Distribution Information window contains a list of all events and errors that have 
occurred during distribution. Choose Distribution Information... from the Information menu. 


The first time this windows comes up it only shows the persistently stored messages. During the 
usage of the Display Tool, all messages will be shown in this list. This means that errors on a 
display later corrected will still be left as messages in the list until the list is updated with the 
refresh command. 


By selecting the item Refresh in the Action menu, everything except the persistently stored 
messages are removed, e.g when a display with errors are successfully distributed are all errors 
removed from the list when a refresh is requested. 


o Distribution Info 

File Action 

Type: Display: Message: View Node Application Time 

OK 10001 Display is installed Process_Sectionlos101 OS Mon Jun 22 1||4 
Vv 

J > 

Views Displays Nodes 
Filters 


Figure 3-27. Distribution Information window 


This list is very useful when tracing faults during distribution. 


3-26 3BSE 007 959R1 RevA 


AdvaBuild® Display Distribution Services User’s Guide 
Section 3.5.10 Message Area 


3.5.10 Message Area 


Details on what is going on is shown in the message area below the list of displays. The mes- 
sage area can be removed by toggle the Show Message Area item in the Information menu. 


Messages: 

Initializing library Process_Section_4 ... 
Initializing library Process_Section_5 ... 
Retrieving distribution messages ... 


Figure 3-28. Message area 


If some operation seems to fail, take a close look in the message area. Errors like trying to dis- 
tribute a display not yet installed is shown as a message in the message area. 


3.5.11 Log Database Distribution for Trend Displays 


For the trend displays the “Log Database Config” tool computes a log database from where data 
is fetched to the trend displays. This database must be present in every node that uses trend dis- 
plays. The Display Distribution Services distributes the log database from any node that is 
present in the view TrendDbView to all other nodes that are present in the view when a “Pub- 
lish database” is requested. 


The procedure below describes the implementation of the functionality: 
° Create the view TrendDbView with the View Configuration function. 


° Add the server node and the client nodes, to which the log database shall be distributed, to 
the view. 


° All clients that not are located in the same plant or control network as the server has to add 
the server node to the Node Broker and connect it. 


° Create the log database with the Log Database Config command (system dialog). 


3.5.12 Local Display Building on Client Nodes 


When change of a display that is part of a view is needed on a client node some preparations is 
needed to prevent from creating conflicts between object code in distribution and object code 
from local installations. 


The procedure below describes necessary steps: 

° Create a temporary library with another name than the distribution directory. 

° Take a copy of the display to the temporary library and rename it to a temporary name. 
° Rebuild the temporary display and test the functionality in the local node. 


° When the new display is finished move it to the server’s display source library using the 
Display Transfer function. 


3BSE 007 959R1 RevA 3-27 


AdvaBuild® Display Distribution Services User’s Guide 
Chapter 3 Configuration/Application Building 


° Rename the temporary display on the server to the original name (Display Builder). 


° Install and distribute the display on the server. 


3.6 Configuration/Application Building Menus 


There are three specific menus for configuration, the View Configuration window, the Node 
Activation window and Default Views window. 


The View Configuration menu bar contains two menus, a File menu and an Action menu, see 
below. 


View Configuration window 


File Action 

Node Activation... Add View... 

Close Delete View... 
Rename View... 
Add Node... 


Remove Node... 


Figure 3-29. View Configuration menu 


The File menu contains the following entries: 
¢ Node Activation to bring up the Node Activation service. 


° Close to exit the service. 


The Action menu contains the following operations: 
° Add View which adds a view to the view list. 


° Delete View deletes a view. If displays are distributed to this view an information box is 
displayed which asks the operator to first uninstall remote the displays from the selected 
view. 


° Rename View renames a view. 


° Add Node which adds a node to the “Nodes not in view” list. The name you input is 
checked against the name used for the UNIX TCP/IP node name. If you get problems in 
the display distribution, check the node names manually by looking in the file /etc/hosts to 
see that the name is a valid reference to an Advant Station 500 Series Operator Station. 


° Remove Node removes a node. If the node that are about to be moved contains displays 
there is a confirmation box displayed which asks the operator to confirm the action. 
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The Node Activation menu bar contains two menus, a File menu and an Action menu, see 
below. 


Node Activation window 


File Action 

Close Suspend Server 
Set Suspended 
Set Protected 
Set Running 


Figure 3-30. Node Activation menu overview 


The File menu contains the following entries: 


Close to exit the service. 


The Action menu contains the following operations: 


Resume Server sets the server in state running. This will start all distribution and 
redistribution of displays. 


Suspend Server sets the server in state suspended. This will stop all distribution and 
redistribution of displays. 


Set Suspended sets the selected nodes in state suspended. This means that they will not 
any longer get any updated displays. 


Set Protected sets the selected nodes in state protected. This means that they will get all 
updated displays, but displays removed from a view will not be removed from the node 
until the nodes are set in state running. 


Set Running sets the selected nodes in state running. All changes in the display server will 
be propagated to the node immediately. 


The Default Views function does not have any menu bar. It contains a possibility to set a default 
view for each library which then is confirmed with an OK button. The view defined for each 
library will then be selected as default view in the distribute function. 
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Chapter 4 Runtime Operation 


4.1 Operating Overview 


The Display Tool is used to install displays, configure and supervise display distribution in a 
network of Advant Station 500 Series Operator Stations. During runtime the display 
installation, distribution as well as the state of all nodes connected to the display server are 
supervised. 


4.2 Operating Instructions 


4.2.1 Installation of a Display 


Installation of a display makes a display available in the display menu for the operator. The 
operation converts the display from its source form to an object form and puts it in the display 
menu, if wanted, of the running operator station. This will make the display possible to use as a 
Base Display and/or an Overlap Display on an operator station. 


To install a display with the Display Tool the following must be done: 


1. Select the displays that you want to install. Selection can be done in several ways as 
defined by OSF/Motif, here are some described: 


— By clicking on the display in the display select area 
— By pressing <Shift> and click or drag over a set of displays 


— By pressing <Control> and click on a display the selection is toggled. 
A selected display gets unselected and the reverse. 


— By using one of the options in the Select menu. 


2. Select Install menu item in the Action menu or select Install from the popup dialog. 
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o Display Tool 
File Select = |7Xeifeyn Information Installing Distributing Uninstalling Errors Help 
Install 
View focus Distribute 
Uninstall Inst Dist Display Views Description 
Remove Source 
Move Displays TREND1 Process Section_2 Scrubber speed. 
Category Add Library Ee 
Remove Library | | | TREND2 _‘ Process_Section_2 Process engines temp. 
Libraries Rename Library 
Reload Display Info eal il TREND3 __— Process_Section_2 Process flow and alarms. 


Process_Section_1 


Process_Section_2 
Process_Section_3 
Process_Section_4 
Process_Section_5 
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Figure 4-1. Install a display in the Display Tool 


3. Select how to install the display from the popup dialog shown below. 


= Install 


Install the selected displays 
© Asis 

< In menu 

<> Not in menu 


OK Cancel 


Figure 4-2. Install dialog box 


As is install means to install the display the same way it was installed previous time. If this 
is the first time the display is installed, it is the same as Install and put in Menu. 


In Menu install means to install the display and make it available in the display menu. 


Not in Menu install means to install the display, but do not make it available in the display 
menu. This option is useful if it is not normal process displays e.g. FixedDisplay, User 
logo. A display installed without menu install is also available for the operator, but it has to 
be selected by giving the display name explicitly. 


4. Press OK to start the installation. 
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The icon in the Install column before the display name shows the current installation state for 


the display. 


The installation icons have the following meaning: 


Table 4-1. Status of the installation icons 


Icon 


Color 


Description 


Grey (filled) 


Not installed. The display is not installed. 


Green (filled with 
a black corner) 


Installed. The display is installed, but not available 
in the Display Menu. 


Green (filled) 


Installed. The display is installed. 


Green (filled 
with a circle) 


Source code changed. The display is installed, 
but the source code has been changed since 
last installation. 


Green (half filled) 


Different source code. The display is installed and 
the last installation of the display was done from 
source code with the same name but in another 
library, category. 


Yellow (filled with 
an hour-glass) 


Installing. The display is under installation. 


Red 


Error. The latest installation of the display went 
wrong. 


To find out the cause of an installation error, click on the red icon and read the description that 


comes up. 


An extra gray icon in front of the other two icons, means that the source code is removed for a 
display. 


Icons indicating 
that the source 
code is missing 


Src Inst Dist Display Views 


|| TREND1 Process_Sectioning 
|| TREND2 Process_ Sectioning 
i” TREND3 Process_Sectioning 


Figure 4-3. Missing source code indication 
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4.2.2 Distribution of a Display 


Before the distribution starts the first time, all nodes have to be set in running state. This is done 
with the Node activation... option under the File menu. For information about the Node 
activation window see Section 3.5.6, Node Activation. 


The distribution also generates status information for each display distributed. This status infor- 
mation can be examined in information windows activated from the Information menu. 


To distribute a display you must install it locally. Our recommendation is that you also bring up 
the display on the local operator station to verify that it looks and behaves correctly. The local 
installation is described in Chapter 4.2.1, Runtime Operation. 


When you are satisfied with a display select the Distribute menu item from the Action menu. 
See Figure 4-4 below. 


o Display Tool 
File Select Actio Information Installing Distributing Uninstalling Errors Help 
Install 
View focus aa 
Uninstall Inst Dist Display Views Description 
Remove Source 
Move Displays TREND1 Process_Section_2 Scrubber speed. 
Category Add Library ae 
Remove Library | || TREND2 Process_Section_2 Process engines temp. 
Libraries Rename Library 
Reload Display Info WS ) TReNds Process_Section_2 Process flow and alarms. 


Process_Section_1 


Process_Section_2 
Process_Section_3 
Process_Section_4 
Process_Section_5 


Figure 4-4. Distribute with Display Tool 
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4.2.2.1 Distribute a Display to a View 


Addition of displays to the view is done in the display area in the main Display Tool window, 
see Figure 3-9. 


The following steps are used to add displays to a view: 
1. Select the set of displays you want to distribute to a view by clicking on the display names. 


2. Select Distribute... from the action menu and select the view to add the display to from the 
list of views. The alternative Add to selected view and distribute is selected. 


= Distribute 


Distribute the selected displays 
© Distribute 
© Install and distribute 
® Add to selected view and distribute 


Process Section 1 
Process Section 2 


OK Help 


Figure 4-5. Move Displays dialog box 
Distribute means to distribute the selected displays(s) to the nodes they already are 
distributed to. 


Install and distribute means to install and distribute the already installed and distributed 
display(s) to the nodes they are distributed to. 


Add to selected view and distribute means to add not previously distributed display(s) to 
a view and distribute it to the selected or default defined view. 


3. Press OK. 


The distribution will start after a 10 seconds delay, but the operation may take a couple of 
minutes before it is completed. The delay allows the operator to select more than one 
display before the distribution is started and thus improve the performance. 
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4.2.2.2 Using a Default View 


The menu item Default Views.. under the File menu contains a possibility to set a default view 
for each library. Select library and a view and press OK to set default view. 


The default view will then be selected as default view in the Distribute.. function. 


= Default Library -- View 

Libraries Views 
ALARM_LINE A\ |Process_Section_1 
ALARM_LIST Process Section_2 


Process Section_1 
Process Section 2 
Process _Section_3 
Process Section_4 
Process Section_5 
EVENT_LIST 
examples 

SYSTEM _LIST 


OK 


Figure 4-6. Default Views window 
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4.2.2.3 Display Distribution Status 


The display distribution status is indicated with an icon in the Dist column of the main window 
of the Display Tool. 
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The distribution icons can be one of the following: 


Table 4-2. Status of the distribution icons 


Icon 


Color 


Description 


Grey (filled) 


Not distributed. The display has not been 
distributed. 


Green (filled with 
a black corner) 


Distributed. The display has been distributed, but it 
is not available in the Display Menu. 


in Green (filled) Distributed. The display has been distributed. 

oO Green (filled Object code changed. The display has been 

with a circle) distributed, but the object code has been changed 
since last distribution. 

A Green (half filled) | Different display. Another display with the same 
name has been installed and the last distribution of 
the display was done from another library. 

[x] Yellow (filled with | Distributing. The display is under distribution. 

an hour-glass) 
Red Error. The latest distribution of the display went 


wrong. 
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4.2.3 On-going Activities 


The menu items Installing, Distributing, Uninstalling and Errors give information about the 
current activities. 


° Installing 


Contains a list of displays in the queue to be installed and the display currently under 
installation. When selected it is a possible to remove an item from the list and thus abort 
ongoing job. 


° Distributing 

Contains a list of displays currently waiting to be distributed. 
° Uninstalling 

Contains a list of displays currently selected to be uninstalled. 
° Errors 


Contains a list of displays where there has been an error or warning during installation or 
distribution. When selected more information about the display is shown in a popup 
window. 


4.2.3.1 Installing Menu 


4.2.3.2 Errors 
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The Installing menu lists all displays currently marked to be installed. From this list it is possi- 
ble to cancel an installation. To do this select the display you want to cancel the installation for. 
A popup dialog comes up where you have to verify the cancellation. It is also possible to cancel 
all ongoing installations from the popup dialog. A way to stop all distribution is to suspend a 
node, this stops all further treatment of displays for that node until the node are set running 
again. 


The Errors menu lists all displays with an error during installation or distribution. 


Each item in the menu consists of three fields, the display name, the library and last if the error 
occured during installation or during distribution. 


By selecting a display an information box comes up with detailed information about the error. 
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4.3 Runtime Operation Menus 


This section gives an overview of all menus available in the AdvaBuild Display Tool. 


File Select Action Information (On-going activities) Help 
View Configuration... Select All Install Overview Info... On Help 
Node Activation... Select New Distribute Display Info... On Window 
Default Views... Select Installed Uninstall View Info... On Version 
Exit Select Distributed Remove Source Node Info... 

Select Modified Move Displays Distribution Info... 

Select Updated Add Library Show Message Area 

Deselect All Remove Library 


Rename Library 
Reload Display Info 


Figure 4-7. Runtime operation menus overview 


The File menu contains the following entries: 


View Configuration to bring up the configuration window. 
Node Activation to bring up the service node activation window. 
Default Views to bring up the directory default view selector. 


Exit to exit the Display Tool. 


The Select menu contains operations to select different sets of displays from the display list. 
The operations are: 
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Select All which selects all displays in current library. 

Select New which selects all displays that have not yet been installed. 

Select Installed selects all displays that are currently installed. 

Select Distributed selects the displays that are currently distributed. 

Select Modified selects all displays that are currently installed but have newer source code. 


Select Updated selects all displays that are distributed, but the installed version is newer than 
the distributed version. 


Deselect All 


4-9 


AdvaBuild® Display Distribution Services User’s Guide 


Chapter 4 Runtime Operation 


4-10 


The Action menu contains operations for installation, distribution and for source code handling. 
The operations are: 


Install will install all selected displays in the current library and current category. 
Distribute will distribute all selected displays in the current library and current category. 
Uninstall will uninstall all selected displays in the current library and current category. 


Remove Source will remove source for the selected displays. The displays must be unin- 
stalled first. 


Move Displays will move or copy all selected displays to the library selected in the dialog 
box. 


Add Library will add a new library. 


Remove Library will remove a library. All displays have to be removed before the library 
can be removed. 


Rename Library will rename a library. 


Reload Display Info will reload display information from persistent storage. Updates display 
information from the file system for the Display Tool. 


The Information menu contains operations for different status information . 
The operations are: 


Overview Info window will give overview information about the contents in display libraries 
and in distribution views. 


Display Info window gives complete information about one display. 


View Info window will for a selected view display the nodes that are part of the view and the 
status of the displays that are to be distributed to the view. 


Node Info window will show all displays that have been specified to be distributed to a node 
and the status of the distribution of each display. 


Distribution Info window contains a list of all events and errors that have ocured during dis- 
tribution. 


Show Message Area toggles the Message Area on and off. The Message Area shows selected 
details on what is going on. 
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The menu items for ongoing activities Installing, Distributing, Uninstalling and Errors give 
information about the current activities: 


¢ Installing Contains a list of displays in the queue to be installed and the display currently 
installing. 


¢ Distributing Contains a list of displays currently waiting to be distributed 
¢ Uninstalling Contains a list of displays currently waiting to be uninstalled 


¢ Errors Contains a list of displays where there has been an error or warning during installation 
or distribution. 


The Help menu contains three entries: 
¢ On Help gives help on the main window itself 
¢ On Window gives help about the keys that are defined in the window 


¢ On Version shows the software version for the tool 
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Chapter 5 Maintenance 


5.1 Maintenance 


The Display Tool is also used to maintain the displays and the display libraries. It is possible to 
remove, copy, move and rename displays and libraries using the Display Tool. 


The functions are activated by selecting the Library and Display Handling items in the Action 
menu. 


oO Display Tool 


File Select Action Information Installing Distributing Uninstalling Errors Help 
Install 
View focus Devens 
Uninstall Inst Dist Display Views Description 
Remove Source 
Move Displays TREND1 Process Section_2 Scrubber speed. 
Category Add Library ae 
Remove Library ] | TREND2 _‘— Process_Section_2 Process engines temp. 
Libraries Rename Library 
Reload Display Info MS (J TRENDS ~——Process_Section_2 Process flow and alarms. 


Process_Section_1 
Process_Section_2 
Process_Section_3 
Process_Section_4 
Process_Section_5 


Figure 5-1. Library and display handling with Display Tool 
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5.1.1 Library Handling 


Library handling can be performed by using the following activities in the Action menu: 


5-2 


Add Library 
Add a new library. 


= Add Library 


Enter new library name: 


OK Cancel 


Figure 5-2. Add Library dialog box 


Remove Library 


Remove a library. A library can only be removed if all displays in the library are removed 
first. Removal of a library has to be confirmed before the action is performed. 


= Remove Library 


? Remove the selected library? 


OK Cancel 


Figure 5-3. Remove Library dialog box 
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° Rename Library 


Rename the library. 


= Rename Library 


Rename the selected library to: 


OK Cancel 


Figure 5-4. Rename Library dialog box 


5.1.2 Display Handling 
Display handling can be performed by selecting the following activites in the Action menu: 
° Move Displays 
— Move the selected displays from one library to another 


— Copy the selected displays from one library to another 


= Move Displays 


Move the selected displays 
to the selected library 


® Move 
© Copy 


ALARM_LINE a 
ALARM_LIST 

Process Section_1 
Process Section_2 
Process Section_3 7 


OK Help 


Figure 5-5. Move Displays dialog box 
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° Uninstall the selected displays from a library 
There are two levels of uninstall for a display. 


— Uninstall the display from all remote nodes it is distributed to. 
This level also removes the display from all views it was added to. 


— Uninstall the display from the local node. 
This level is only possible if the display is uninstalled from all remote nodes first. 


a) Uninstall 


Uninstall the selected displays 
From local node 


From all remote nodes 


OK 


Figure 5-6. Uninstall dialog box 


° Remove the selected displays 


The source code are removed. Remove is only possible if the displays are uninstalled from 
all remote nodes and the local node. 


= Remove Source 


Remove the source code 
for the selected displays? 
DETAILDRYER 


OK Cancel 


Figure 5-7. Remove source dialog box 


CAUTION 


To remove the source code is irreversible. Once removed and it is gone for ever, 
unless you bring it in from a backup tape. 
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5.2 Error Messages 
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The following error messages may occur in the Distribution Information window when using 
the Display Tool: 
The distribution view file can not be opened 


Check the protection on the .dvf-files found in the directory 
/product/data/customer/OS/config. 


Error during restore of distribution view files 


The .dvf file/files for the view has been corrupted for some reason. Remove the files and 
rebuild them again using the Display Tool. 


Error during store of distribution view file <File name>. 


Check the protection on the directory and on the .dvf-file. 


The installer at node <Node name> has wrong protocol version <version>. 


The display server is not able to handle a display client with a newer version than the 
display server. Remove the failing node from the distribution, or change the display server 
to a later revision. 


The file <File name> is newer than server file. It is not distributed. 


The version of the file is newer on the display client than the version in the display server. 
This may occur if the clocks on the two operator stations is not synchronized. 


Can not create config directory <directory>. 


Check the protection on the directory /product/data/customer/OS/config. 
Can’t install <display name>. 


Check the messages following this message. Common reason for installation failure is that 
the display elements have different versions, or is missing in the display client. 
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5.3 Fault Finding and User Repair 


If any operation seems to fail, start with checking the Message Area and the Distribution infor- 
mation window reachable from the Information menu. 


° The distribution icon do not change from yellow to green 


A remaining yellow icon indicates that the distribution is not yet completed. Double click 
on the display in the main window brings up the Display Info window. Look for nodes that 
are missing transferred OK flag in the node list. 


Select the Node activation.. in the File menu and check the status on all nodes. 


If all nodes are active and reachable, then select Distribution information.. in the Infor- 
mation menu, and look for error messages from the failing display. 


° The distribution icon is turning red 


A red icon indicates that the distribution is terminated with an error. Click on the red icon 
to get more information about the error. 


One type of error is “Can not install the display” from one of the remote nodes. In most 
cases this error means the display contains display elements not available on the remote 
node. If you have any own display elements, check that they are installed. 
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